home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / tk2.3 / dist / tkCursor.c < prev    next >
Encoding:
C/C++ Source or Header  |  1991-10-31  |  18.6 KB  |  640 lines
  1. /* 
  2.  * tkCursor.c --
  3.  *
  4.  *    This file maintains a database of read-only cursors for the Tk
  5.  *    toolkit.  This allows cursors to be shared between widgets and
  6.  *    also avoids round-trips to the X server.
  7.  *
  8.  * Copyright 1990 Regents of the University of California
  9.  * Permission to use, copy, modify, and distribute this
  10.  * software and its documentation for any purpose and without
  11.  * fee is hereby granted, provided that the above copyright
  12.  * notice appear in all copies.  The University of California
  13.  * makes no representations about the suitability of this
  14.  * software for any purpose.  It is provided "as is" without
  15.  * express or implied warranty.
  16.  */
  17.  
  18. #ifndef lint
  19. static char rcsid[] = "$Header: /user6/ouster/wish/RCS/tkCursor.c,v 1.12 91/10/31 11:40:41 ouster Exp $ SPRITE (Berkeley)";
  20. #endif /* not lint */
  21.  
  22. #include "tkConfig.h"
  23. #include "tkInt.h"
  24.  
  25. /*
  26.  * One of the following data structures exists for each cursor that is
  27.  * currently active.  Each structure is indexed with two hash tables
  28.  * defined below.  One of the tables is idTable, and the other is either
  29.  * nameTable or dataTable, also defined below.
  30.  * .
  31.  */
  32.  
  33. typedef struct {
  34.     Cursor cursor;        /* X identifier for cursor. */
  35.     Display *display;        /* Display for which cursor is valid. */
  36.     int refCount;        /* Number of active uses of cursor. */
  37.     Tcl_HashTable *otherTable;    /* Second table (other than idTable) used
  38.                  * to index this entry. */
  39.     Tcl_HashEntry *hashPtr;    /* Entry in otherTable for this structure
  40.                  * (needed when deleting). */
  41. } TkCursor;
  42.  
  43. /*
  44.  * Hash table to map from a textual description of a cursor to the
  45.  * TkCursor record for the cursor, and key structure used in that
  46.  * hash table:
  47.  */
  48.  
  49. static Tcl_HashTable nameTable;
  50. typedef struct {
  51.     Tk_Uid name;        /* Textual name for desired cursor. */
  52.     Display *display;        /* Display for which cursor will be used. */
  53. } NameKey;
  54.  
  55. /*
  56.  * Hash table to map from a collection of in-core data about a
  57.  * cursor (bitmap contents, etc.) to a TkCursor structure:
  58.  */
  59.  
  60. static Tcl_HashTable dataTable;
  61. typedef struct {
  62.     char *source;        /* Cursor bits. */
  63.     char *mask;            /* Mask bits. */
  64.     unsigned int width, height;    /* Dimensions of cursor (and data
  65.                  * and mask). */
  66.     int xHot, yHot;        /* Location of cursor hot-spot. */
  67.     Tk_Uid fg, bg;        /* Colors for cursor. */
  68.     Display *display;        /* Display on which cursor will be used. */
  69. } DataKey;
  70.  
  71. /*
  72.  * Hash table that maps from Cursor identifiers to the TkCursor structure
  73.  * for the cursor.  This table is indexed by Cursor ids, and is used by
  74.  * Tk_FreeCursor.
  75.  */
  76.  
  77. static Tcl_HashTable idTable;
  78.  
  79. static int initialized = 0;    /* 0 means static structures haven't been
  80.                  * initialized yet. */
  81.  
  82. /*
  83.  * The table below is used to map from the name of a cursor to its
  84.  * index in the official cursor font:
  85.  */
  86.  
  87. static struct CursorName {
  88.     char        *name;
  89.     unsigned int    shape;
  90. } cursorNames[] = {
  91.     {"X_cursor",        XC_X_cursor},
  92.     {"arrow",            XC_arrow},
  93.     {"based_arrow_down",    XC_based_arrow_down},
  94.     {"based_arrow_up",        XC_based_arrow_up},
  95.     {"boat",            XC_boat},
  96.     {"bogosity",        XC_bogosity},
  97.     {"bottom_left_corner",    XC_bottom_left_corner},
  98.     {"bottom_right_corner",    XC_bottom_right_corner},
  99.     {"bottom_side",        XC_bottom_side},
  100.     {"bottom_tee",        XC_bottom_tee},
  101.     {"box_spiral",        XC_box_spiral},
  102.     {"center_ptr",        XC_center_ptr},
  103.     {"circle",            XC_circle},
  104.     {"clock",            XC_clock},
  105.     {"coffee_mug",        XC_coffee_mug},
  106.     {"cross",            XC_cross},
  107.     {"cross_reverse",        XC_cross_reverse},
  108.     {"crosshair",        XC_crosshair},
  109.     {"diamond_cross",        XC_diamond_cross},
  110.     {"dot",            XC_dot},
  111.     {"dotbox",            XC_dotbox},
  112.     {"double_arrow",        XC_double_arrow},
  113.     {"draft_large",        XC_draft_large},
  114.     {"draft_small",        XC_draft_small},
  115.     {"draped_box",        XC_draped_box},
  116.     {"exchange",        XC_exchange},
  117.     {"fleur",            XC_fleur},
  118.     {"gobbler",            XC_gobbler},
  119.     {"gumby",            XC_gumby},
  120.     {"hand1",            XC_hand1},
  121.     {"hand2",            XC_hand2},
  122.     {"heart",            XC_heart},
  123.     {"icon",            XC_icon},
  124.     {"iron_cross",        XC_iron_cross},
  125.     {"left_ptr",        XC_left_ptr},
  126.     {"left_side",        XC_left_side},
  127.     {"left_tee",        XC_left_tee},
  128.     {"leftbutton",        XC_leftbutton},
  129.     {"ll_angle",        XC_ll_angle},
  130.     {"lr_angle",        XC_lr_angle},
  131.     {"man",            XC_man},
  132.     {"middlebutton",        XC_middlebutton},
  133.     {"mouse",            XC_mouse},
  134.     {"pencil",            XC_pencil},
  135.     {"pirate",            XC_pirate},
  136.     {"plus",            XC_plus},
  137.     {"question_arrow",        XC_question_arrow},
  138.     {"right_ptr",        XC_right_ptr},
  139.     {"right_side",        XC_right_side},
  140.     {"right_tee",        XC_right_tee},
  141.     {"rightbutton",        XC_rightbutton},
  142.     {"rtl_logo",        XC_rtl_logo},
  143.     {"sailboat",        XC_sailboat},
  144.     {"sb_down_arrow",        XC_sb_down_arrow},
  145.     {"sb_h_double_arrow",    XC_sb_h_double_arrow},
  146.     {"sb_left_arrow",        XC_sb_left_arrow},
  147.     {"sb_right_arrow",        XC_sb_right_arrow},
  148.     {"sb_up_arrow",        XC_sb_up_arrow},
  149.     {"sb_v_double_arrow",    XC_sb_v_double_arrow},
  150.     {"shuttle",            XC_shuttle},
  151.     {"sizing",            XC_sizing},
  152.     {"spider",            XC_spider},
  153.     {"spraycan",        XC_spraycan},
  154.     {"star",            XC_star},
  155.     {"target",            XC_target},
  156.     {"tcross",            XC_tcross},
  157.     {"top_left_arrow",        XC_top_left_arrow},
  158.     {"top_left_corner",        XC_top_left_corner},
  159.     {"top_right_corner",    XC_top_right_corner},
  160.     {"top_side",        XC_top_side},
  161.     {"top_tee",            XC_top_tee},
  162.     {"trek",            XC_trek},
  163.     {"ul_angle",        XC_ul_angle},
  164.     {"umbrella",        XC_umbrella},
  165.     {"ur_angle",        XC_ur_angle},
  166.     {"watch",            XC_watch},
  167.     {"xterm",            XC_xterm},
  168.     {NULL,            0}
  169. };
  170.  
  171. /*
  172.  * Font to use for cursors:
  173.  */
  174.  
  175. #ifndef CURSORFONT
  176. #define CURSORFONT "cursor"
  177. #endif
  178.  
  179. /*
  180.  * Forward declarations for procedures defined in this file:
  181.  */
  182.  
  183. static void        CursorInit _ANSI_ARGS_((void));
  184.  
  185. /*
  186.  *----------------------------------------------------------------------
  187.  *
  188.  * Tk_GetCursor --
  189.  *
  190.  *    Given a string describing a cursor, locate (or create if necessary)
  191.  *    a cursor that fits the description.
  192.  *
  193.  * Results:
  194.  *    The return value is the X identifer for the desired cursor,
  195.  *    unless string couldn't be parsed correctly.  In this case,
  196.  *    None is returned and an error message is left in interp->result.
  197.  *    The caller should never modify the cursor that is returned, and
  198.  *    should eventually call Tk_FreeCursor when the cursor is no longer
  199.  *    needed.
  200.  *
  201.  * Side effects:
  202.  *    The cursor is added to an internal database with a reference count.
  203.  *    For each call to this procedure, there should eventually be a call
  204.  *    to Tk_FreeCursor, so that the database can be cleaned up when cursors
  205.  *    aren't needed anymore.
  206.  *
  207.  *----------------------------------------------------------------------
  208.  */
  209.  
  210. Cursor
  211. Tk_GetCursor(interp, tkwin, string)
  212.     Tcl_Interp *interp;        /* Interpreter to use for error reporting. */
  213.     Tk_Window tkwin;        /* Window in which cursor will be used. */
  214.     Tk_Uid string;        /* Description of cursor.  See manual entry
  215.                  * for details on legal syntax. */
  216. {
  217.     NameKey key;
  218.     Tcl_HashEntry *nameHashPtr, *idHashPtr;
  219.     register TkCursor *cursorPtr;
  220.     int new;
  221.     Cursor cursor;
  222.     int argc;
  223.     char **argv = NULL;
  224.     Pixmap source = None;
  225.     Pixmap mask = None;
  226.  
  227.     if (!initialized) {
  228.     CursorInit();
  229.     }
  230.  
  231.     key.name = string;
  232.     key.display = Tk_Display(tkwin);
  233.     nameHashPtr = Tcl_CreateHashEntry(&nameTable, (char *) &key, &new);
  234.     if (!new) {
  235.     cursorPtr = (TkCursor *) Tcl_GetHashValue(nameHashPtr);
  236.     cursorPtr->refCount++;
  237.     return cursorPtr->cursor;
  238.     }
  239.  
  240.     /*
  241.      * No suitable cursor exists.  Parse the cursor name into fields
  242.      * and create a cursor, either from the standard cursor font or
  243.      * from bitmap files.
  244.      */
  245.  
  246.     if (Tcl_SplitList(interp, string, &argc, &argv) != TCL_OK) {
  247.     goto error;
  248.     }
  249.     if (argc == 0) {
  250.     badString:
  251.     Tcl_AppendResult(interp, "bad cursor spec \"", string, "\"",
  252.         (char *) NULL);
  253.     goto error;
  254.     }
  255.     if (argv[0][0] != '@') {
  256.     XColor fg, bg;
  257.     int maskIndex;
  258.     register struct CursorName *namePtr;
  259.     TkDisplay *dispPtr;
  260.  
  261.     /*
  262.      * The cursor is to come from the standard cursor font.  If one
  263.      * arg, it is cursor name (use black and white for fg and bg).
  264.      * If two args, they are name and fg color (ignore mask).  If
  265.      * three args, they are name, fg, bg.  Some of the code below
  266.      * is stolen from the XCreateFontCursor Xlib procedure.
  267.      */
  268.  
  269.     if (argc > 3) {
  270.         goto badString;
  271.     }
  272.     for (namePtr = cursorNames; ; namePtr++) {
  273.         if (namePtr->name == NULL) {
  274.         goto badString;
  275.         }
  276.         if ((namePtr->name[0] == argv[0][0])
  277.             && (strcmp(namePtr->name, argv[0]) == 0)) {
  278.         break;
  279.         }
  280.     }
  281.     maskIndex = namePtr->shape + 1;
  282.     if (argc == 1) {
  283.         fg.red = fg.green = fg.blue = 0;
  284.         bg.red = bg.green = bg.blue = 65535;
  285.     } else {
  286.         if (XParseColor(key.display,
  287.             DefaultColormapOfScreen(Tk_Screen(tkwin)),
  288.             argv[1], &fg) == 0) {
  289.         Tcl_AppendResult(interp, "invalid color name \"", argv[1],
  290.             "\"", (char *) NULL);
  291.         goto error;
  292.         }
  293.         if (argc == 2) {
  294.         bg.red = bg.green = bg.blue = 0;
  295.         maskIndex = namePtr->shape;
  296.         } else {
  297.         if (XParseColor(key.display,
  298.             DefaultColormapOfScreen(Tk_Screen(tkwin)),
  299.             argv[2], &bg) == 0) {
  300.             Tcl_AppendResult(interp, "invalid color name \"", argv[2],
  301.                 "\"", (char *) NULL);
  302.             goto error;
  303.         }
  304.         }
  305.     }
  306.     dispPtr = ((TkWindow *) tkwin)->dispPtr;
  307.     if (dispPtr->cursorFont == None) {
  308.         dispPtr->cursorFont = XLoadFont(key.display, CURSORFONT);
  309.         if (dispPtr->cursorFont == None) {
  310.         interp->result = "couldn't load cursor font";
  311.         goto error;
  312.         }
  313.     }
  314.     cursor = XCreateGlyphCursor(key.display, dispPtr->cursorFont,
  315.         dispPtr->cursorFont, namePtr->shape, maskIndex,
  316.         &fg, &bg);
  317.     } else {
  318.     unsigned int width, height, maskWidth, maskHeight;
  319.     int xHot, yHot, dummy1, dummy2;
  320.     XColor fg, bg;
  321.  
  322.     /*
  323.      * The cursor is to be created by reading bitmap files.  There
  324.      * should be either two elements in the list (source, color) or
  325.      * four (source mask fg bg).
  326.      */
  327.  
  328.     if ((argc != 2) && (argc != 4)) {
  329.         goto badString;
  330.     }
  331.     if (XReadBitmapFile(key.display, RootWindowOfScreen(Tk_Screen(tkwin)),
  332.         &argv[0][1], &width, &height, &source, &xHot, &yHot)
  333.         != BitmapSuccess) {
  334.         Tcl_AppendResult(interp, "error reading bitmap file \"",
  335.             &argv[0][1], "\"", (char *) NULL);
  336.         goto error;
  337.     }
  338.     if ((xHot < 0) || (yHot < 0) || (xHot >= width) || (yHot >= height)) {
  339.         Tcl_AppendResult(interp, "bad hot spot in bitmap file \"",
  340.             &argv[0][1], "\"", (char *) NULL);
  341.         goto error;
  342.     }
  343.     if (argc == 2) {
  344.         if (XParseColor(key.display,
  345.             DefaultColormapOfScreen(Tk_Screen(tkwin)),
  346.             argv[1], &fg) == 0) {
  347.         Tcl_AppendResult(interp, "invalid color name \"",
  348.             argv[1], "\"", (char *) NULL);
  349.         goto error;
  350.         }
  351.         cursor = XCreatePixmapCursor(key.display, source, source,
  352.             &fg, &fg, xHot, yHot);
  353.     } else {
  354.         if (XReadBitmapFile(key.display,
  355.             RootWindowOfScreen(Tk_Screen(tkwin)), argv[1],
  356.             &maskWidth, &maskHeight, &mask, &dummy1,
  357.             &dummy2) != BitmapSuccess) {
  358.         Tcl_AppendResult(interp, "error reading bitmap file \"",
  359.             argv[1], "\"", (char *) NULL);
  360.         goto error;
  361.         }
  362.         if ((maskWidth != width) && (maskHeight != height)) {
  363.         interp->result =
  364.             "source and mask bitmaps have different sizes";
  365.         goto error;
  366.         }
  367.         if (XParseColor(key.display,
  368.             DefaultColormapOfScreen(Tk_Screen(tkwin)),
  369.             argv[2], &fg) == 0) {
  370.         Tcl_AppendResult(interp, "invalid color name \"", argv[2],
  371.             "\"", (char *) NULL);
  372.         goto error;
  373.         }
  374.         if (XParseColor(key.display,
  375.             DefaultColormapOfScreen(Tk_Screen(tkwin)),
  376.             argv[3], &bg) == 0) {
  377.         Tcl_AppendResult(interp, "invalid color name \"", argv[3],
  378.             "\"", (char *) NULL);
  379.         goto error;
  380.         }
  381.         cursor = XCreatePixmapCursor(key.display, source, mask,
  382.             &fg, &bg, xHot, yHot);
  383.     }
  384.     }
  385.     ckfree((char *) argv);
  386.  
  387.     /*
  388.      * Add information about this cursor to our database.
  389.      */
  390.  
  391.     cursorPtr = (TkCursor *) ckalloc(sizeof(TkCursor));
  392.     cursorPtr->cursor = cursor;
  393.     cursorPtr->display = key.display;
  394.     cursorPtr->refCount = 1;
  395.     cursorPtr->otherTable = &nameTable;
  396.     cursorPtr->hashPtr = nameHashPtr;
  397.     idHashPtr = Tcl_CreateHashEntry(&idTable, (char *) cursorPtr->cursor,
  398.         &new);
  399.     if (!new) {
  400.     panic("cursor already registered in Tk_GetCursor");
  401.     }
  402.     Tcl_SetHashValue(nameHashPtr, cursorPtr);
  403.     Tcl_SetHashValue(idHashPtr, cursorPtr);
  404.     return cursorPtr->cursor;
  405.  
  406.     error:
  407.     Tcl_DeleteHashEntry(nameHashPtr);
  408.     if (argv != NULL) {
  409.     ckfree((char *) argv);
  410.     }
  411.     if (source != None) {
  412.     XFreePixmap(key.display, source);
  413.     }
  414.     if (mask != None) {
  415.     XFreePixmap(key.display, mask);
  416.     }
  417.     return None;
  418. }
  419.  
  420. /*
  421.  *----------------------------------------------------------------------
  422.  *
  423.  * Tk_GetCursorFromData --
  424.  *
  425.  *    Given a description of the bits and colors for a cursor,
  426.  *    make a cursor that has the given properties.
  427.  *
  428.  * Results:
  429.  *    The return value is the X identifer for the desired cursor,
  430.  *    unless it couldn't be created properly.  In this case, None is
  431.  *    returned and an error message is left in interp->result.  The
  432.  *    caller should never modify the cursor that is returned, and
  433.  *    should eventually call Tk_FreeCursor when the cursor is no
  434.  *    longer needed.
  435.  *
  436.  * Side effects:
  437.  *    The cursor is added to an internal database with a reference count.
  438.  *    For each call to this procedure, there should eventually be a call
  439.  *    to Tk_FreeCursor, so that the database can be cleaned up when cursors
  440.  *    aren't needed anymore.
  441.  *
  442.  *----------------------------------------------------------------------
  443.  */
  444.  
  445. Cursor
  446. Tk_GetCursorFromData(interp, tkwin, source, mask, width, height,
  447.     xHot, yHot, fg, bg)
  448.     Tcl_Interp *interp;        /* Interpreter to use for error reporting. */
  449.     Tk_Window tkwin;        /* Window in which cursor will be used. */
  450.     char *source;        /* Bitmap data for cursor shape. */
  451.     char *mask;            /* Bitmap data for cursor mask. */
  452.     unsigned int width, height;    /* Dimensions of cursor. */
  453.     int xHot, yHot;        /* Location of hot-spot in cursor. */
  454.     Tk_Uid fg;            /* Foreground color for cursor. */
  455.     Tk_Uid bg;            /* Background color for cursor. */
  456. {
  457.     DataKey key;
  458.     Tcl_HashEntry *dataHashPtr, *idHashPtr;
  459.     register TkCursor *cursorPtr;
  460.     int new;
  461.     XColor fgColor, bgColor;
  462.     Pixmap sourcePixmap, maskPixmap;
  463.  
  464.     if (!initialized) {
  465.     CursorInit();
  466.     }
  467.  
  468.     key.source = source;
  469.     key.mask = mask;
  470.     key.width = width;
  471.     key.height = height;
  472.     key.xHot = xHot;
  473.     key.yHot = yHot;
  474.     key.fg = fg;
  475.     key.bg = bg;
  476.     key.display = Tk_Display(tkwin);
  477.     dataHashPtr = Tcl_CreateHashEntry(&dataTable, (char *) &key, &new);
  478.     if (!new) {
  479.     cursorPtr = (TkCursor *) Tcl_GetHashValue(dataHashPtr);
  480.     cursorPtr->refCount++;
  481.     return cursorPtr->cursor;
  482.     }
  483.  
  484.     /*
  485.      * No suitable cursor exists yet.  Make one using the data
  486.      * available and add it to the database.
  487.      */
  488.  
  489.     if (XParseColor(key.display, DefaultColormapOfScreen(Tk_Screen(tkwin)),
  490.         fg, &fgColor) == 0) {
  491.     Tcl_AppendResult(interp, "invalid color name \"", fg, "\"",
  492.         (char *) NULL);
  493.     goto error;
  494.     }
  495.     if (XParseColor(key.display, DefaultColormapOfScreen(Tk_Screen(tkwin)),
  496.         bg, &bgColor) == 0) {
  497.     Tcl_AppendResult(interp, "invalid color name \"", bg, "\"",
  498.         (char *) NULL);
  499.     goto error;
  500.     }
  501.  
  502.     cursorPtr = (TkCursor *) ckalloc(sizeof(TkCursor));
  503.     sourcePixmap = XCreateBitmapFromData(key.display,
  504.         RootWindowOfScreen(Tk_Screen(tkwin)), source, width, height);
  505.     maskPixmap = XCreateBitmapFromData(key.display, 
  506.         RootWindowOfScreen(Tk_Screen(tkwin)), mask, width, height);
  507.     cursorPtr->cursor = XCreatePixmapCursor(key.display, sourcePixmap,
  508.         maskPixmap, &fgColor, &bgColor, xHot, yHot);
  509.     XFreePixmap(key.display, sourcePixmap);
  510.     XFreePixmap(key.display, maskPixmap);
  511.     cursorPtr->display = key.display;
  512.     cursorPtr->refCount = 1;
  513.     cursorPtr->otherTable = &dataTable;
  514.     cursorPtr->hashPtr = dataHashPtr;
  515.     idHashPtr = Tcl_CreateHashEntry(&idTable, (char *) cursorPtr->cursor, &new);
  516.     if (!new) {
  517.     panic("cursor already registered in Tk_GetCursorFromData");
  518.     }
  519.     Tcl_SetHashValue(dataHashPtr, cursorPtr);
  520.     Tcl_SetHashValue(idHashPtr, cursorPtr);
  521.     return cursorPtr->cursor;
  522.  
  523.     error:
  524.     Tcl_DeleteHashEntry(dataHashPtr);
  525.     return None;
  526. }
  527.  
  528. /*
  529.  *--------------------------------------------------------------
  530.  *
  531.  * Tk_NameOfCursor --
  532.  *
  533.  *    Given a cursor, return a textual string identifying it.
  534.  *
  535.  * Results:
  536.  *    If cursor was created by Tk_GetCursor, then the return
  537.  *    value is the "string" that was used to create it.
  538.  *    Otherwise the return value is a string giving the X
  539.  *    identifier for the cursor.  The storage for the returned
  540.  *    string is only guaranteed to persist up until the next
  541.  *    call to this procedure.
  542.  *
  543.  * Side effects:
  544.  *    None.
  545.  *
  546.  *--------------------------------------------------------------
  547.  */
  548.  
  549. char *
  550. Tk_NameOfCursor(cursor)
  551.     Cursor cursor;            /* Cursor to be released. */
  552. {
  553.     Tcl_HashEntry *idHashPtr;
  554.     TkCursor *cursorPtr;
  555.     static char string[20];
  556.  
  557.     if (!initialized) {
  558.     printid:
  559.     sprintf(string, "cursor id 0x%x", cursor);
  560.     return string;
  561.     }
  562.     idHashPtr = Tcl_FindHashEntry(&idTable, (char *) cursor);
  563.     if (idHashPtr == NULL) {
  564.     goto printid;
  565.     }
  566.     cursorPtr = (TkCursor *) Tcl_GetHashValue(idHashPtr);
  567.     if (cursorPtr->otherTable != &nameTable) {
  568.     goto printid;
  569.     }
  570.     return ((NameKey *) cursorPtr->hashPtr->key.words)->name;
  571. }
  572.  
  573. /*
  574.  *----------------------------------------------------------------------
  575.  *
  576.  * Tk_FreeCursor --
  577.  *
  578.  *    This procedure is called to release a cursor allocated by
  579.  *    Tk_GetCursor or TkGetCursorFromData.
  580.  *
  581.  * Results:
  582.  *    None.
  583.  *
  584.  * Side effects:
  585.  *    The reference count associated with cursor is decremented, and
  586.  *    it is officially deallocated if no-one is using it anymore.
  587.  *
  588.  *----------------------------------------------------------------------
  589.  */
  590.  
  591. void
  592. Tk_FreeCursor(cursor)
  593.     Cursor cursor;            /* Cursor to be released. */
  594. {
  595.     Tcl_HashEntry *idHashPtr;
  596.     register TkCursor *cursorPtr;
  597.  
  598.     if (!initialized) {
  599.     panic("Tk_FreeCursor called before Tk_GetCursor");
  600.     }
  601.  
  602.     idHashPtr = Tcl_FindHashEntry(&idTable, (char *) cursor);
  603.     if (idHashPtr == NULL) {
  604.     panic("Tk_FreeCursor received unknown cursor argument");
  605.     }
  606.     cursorPtr = (TkCursor *) Tcl_GetHashValue(idHashPtr);
  607.     cursorPtr->refCount--;
  608.     if (cursorPtr->refCount == 0) {
  609.     XFreeCursor(cursorPtr->display, cursorPtr->cursor);
  610.     Tcl_DeleteHashEntry(cursorPtr->hashPtr);
  611.     Tcl_DeleteHashEntry(idHashPtr);
  612.     ckfree((char *) cursorPtr);
  613.     }
  614. }
  615.  
  616. /*
  617.  *----------------------------------------------------------------------
  618.  *
  619.  * CursorInit --
  620.  *
  621.  *    Initialize the structures used for cursor management.
  622.  *
  623.  * Results:
  624.  *    None.
  625.  *
  626.  * Side effects:
  627.  *    Read the code.
  628.  *
  629.  *----------------------------------------------------------------------
  630.  */
  631.  
  632. static void
  633. CursorInit()
  634. {
  635.     initialized = 1;
  636.     Tcl_InitHashTable(&nameTable, sizeof(NameKey)/sizeof(long));
  637.     Tcl_InitHashTable(&dataTable, sizeof(DataKey)/sizeof(long));
  638.     Tcl_InitHashTable(&idTable, TCL_ONE_WORD_KEYS);
  639. }
  640.